SIMULATED INSTRUCTIONS FOR COMPASS PROGRAMS 



There are a number of instructions that are illegal for a 
program that is not in monitor state to use. 0S~3 has attached 
special meaning to some of these so that a user can communicate 



\v -l c.n 



the monitor to do I/O, check for various faults, or get 
the status of his job. 



information a.oout 

The followina is a brief description of these instructions, 

their puposes, their COMPASS ^apemonic^, and the forma^ 

s *~ 

assembled instruction. 



md the format of the 



READ WRITE CNTL XREQ 



effective addresses on these 
instructions are computed as 
follows: 



D 



A^ka^* 



15 



m 



if I 
if I 



M = m+B^ 



1 /fetch bits 17-0 from location M and repeat 
0v'*M specifies the LUN to usef) € LUN <t 100 J 



h 



READ read a record on LUN 

f=74<y 



WRITE 



f=76<7 



«» 



I 



write a record on LUN 
15 



A 



Q 



1 



first v;ord address 



S- 1 2 r 



16 



m 



word count 



b = start in same bank 

as the £L"J- instructio: 
b = 1 start in other bank 

m = BCD mode 
m = 1 binary mode 



LUN must be defined, j^Eter a READ or WRITE operate the status of 
the LUN (see CNTL)/. After read Q^.^S 1 ?7 r ^^^' dumber of words 
in the record) 



^ $ ^ h, * 






■*_., ****>? 



& \>« o 



CNTL 



£=72.0 



Issue CONTROL function in lower 
15 bits of Q to LUN. After the 
operation the status of the unit 
is returned in A, all other 
registers are unchanged. For all 
functions except status LUN must 
be defined or the user is put in-L— 
control mode. 



CONTROL CODES 



SYMBOLIC NAME 



OCTAL COD] 



STATUS 
CLEAR 

WFM 

RELEASE 

REWINx5)P 

SFPFM 

S3PFM 

BKSPACS 

F WD SPACE 

Status of device in A 





1 

2 
3 

4 
5 
6 
7 
10 




.e marx & binary 



output un 



copy status olfiL^o A 

clear status o: 

bits ) 

write file mark 

release file or 

rewind to load point 

search forward pas- 

search backward past file mark 

backspace one record 

space forward one (" ~3^* record 



15 



STATUS 



TYPE 



23 



15 1- 



STATUS 



TYPE 



BIT MASK 



CONDITION 



23 
22 
21 
20 
19 
18 

17 
16 
15 



40000000 
20000000 
10000000 
04000000 
02000000 
01000000 

00400000 
00200000 
00100000 



READ ONLY (FILE PROTECT) 

LOAD P©if$jEGINNING OF FILE; 

END OF DATA 

FM just processed 

NOT USED 

BINARY RECORD just $L®^ 



ABNORMAL/UNAVAILABLE 
ADDRESS ERROR 
SAVED FILE 



= 

1 = 

2 = 

3 = 

4 = 

5 = 

6 = 

7 = 



9 
10 
11 



UNIT NOT EQUIPPED 

FILE 

LINE PRINTER 

CARD PUNCH 

CARD READER 

MAGNETIC TAPE wX hi 

TELETYPE Jp" 

PLOTTER \^ 

NULL (ABSORBS ALL 

OUTPUT) 

TV (DISPLAY CONSOLE) 

RANDOM ACCESS FILE 

TASK (REMOTE BATCH 

J03) 



XREQ executive request - used to equip LUNs , 

f = 71.0 save, delete, file protect, and remove 

file protect on files ,V call library 



AQ Name of file or library program, in BCD character codes. 
Is left unchanged except in case of EQUIP and UNEQUIP. 

Bl Code for action desired. After operation, contains an erro: 
code (0 means no error) . 

effective address (M) : logical unit number (0 to 99) or memory 
page number (0 to 37 o) / or not used. 



CODE 
in Bl Request Action and error conditions 

DELETE Delete file name (in AQ) from file directory. 

File must be equipped as the specified logical 
unit. 

ERROR 

1 unit is not equipped 

2 file is protected 

3 unit is not a saved file 

4 name in AQ does not agree with name of 

file 

5 not enough scratch file space for file 

1 SAVE Save specified logical unit under name in AQ 

(put name in file directory) . 

ERROR 

1 unit is not equipped 

2 there already exists a file with the 

name given in AQ 

3 unit is already a saved file 

4 unit is not a file 

5 not enough saved file space for file 

6 name is illegal (such as FILE, PUN, etc.) 



UNEQUIP 



Unequip the specified logical unit. If LUN 
is a tape the density code Of the tape is 
returned in A, otherwise AQ is not changed. 



ERROR 



i unit is not equipped 

2 unit is a file or RA? which is protected 
and not saved 



EQUIP 



If A ^ 0, equip specified unit as the saved 

ilxe vaiusc aaiiic j-b -Lajl c±\l t WJL ci ' => ^ A *~ iiaj.Uv»ai.t: 

unit whose name is in AQ. See list below. 
If A = i 0, equip specified unit as equivalent 
to the unit number specified AJ> Q(0 to 100). 
If no error occurs , A contains the status of 
the unit after equipping it. 

HARDWARE NAMES (in AQ) : 

FILE create an empty scratch file 
LP line printer 

a?^: -S amG 1 "S .-S — xtP — 



r'UJN 

PLOT 

RA? 

TASK 

NULL 

MT 



card punch 

plotter 

create an empty random access file 

remote batch job 

null (device absorbs and discards 

all outputs to it) 
(in A) magnetic tape 
IQ) = reel number 

St = .densitv 

= 200 BPI 

1 = 550 BPI 

2 = 800 BPI 



RFP 



ERROR 

1 
2 

3 

4 



unit is already equipped 

there is no saved file with the name 

given in AQ 
unit number (in Q) is not equipped 
saved file with name in AQ is bv.sy 

(it is not protected and some other 

user has ^it equipped.) 

illegal tape number or density 
} \ i ah.. B j^ ax^Aaa»^ ^3i8^ga@5^3^a^ e 



Remove file protection from specified unit. 
If it is saved, its name must be given in AQ 
If it is not saved, AQ is ignored. 




ERROR 



1 unit is not equipped 



FP 



2 file is busy (some other user is 

equipped to it, too) . 

3 name in AQ does not agree v/ith the 

name of the file 

4 file is public or semi-public and 

it belongs to some other user. 

Protect the file which is equipped to the 
SDecified unit. AQ is ignored. 



ERROR 



Unused 
ZEROPAGE 



1 unit is not equipped 

2 unit is not a file 







Effective address (0 to 37 g ) specified a 
page in memory, which is set to ail zero. 
A page is 2048' words, and they are numbered 
from the low end of memory J upward. Thus, 
page extends from address 000000 to 
003777, page 13 extends from 054000 to 057777, 
etc. t\Q us rgnorec. . 



LIBCALL Call the library program whose name is in 

AQ. This involves copying the program into 
the pages of memory which it is to occupy, 
and. transferring control to it. If the 
library program needs a parameter string, 
this must have been defined previously by 
storing ASCII characters, using the ACI 
instruction. The effective address is 
ignored. 



ERROR 



RF77 



bits 

23 
22 



If there is no library program by the 
name given in AQ, nothing is done and the 
computer executes the next instruction 
after the XREQ. 




ABORT THE USER 
RESTRICTED MODE 



MOD^-37 TTY 

DATE 

DELETE LOADING 



Qrpj Console Teletype input — read a character 

77 - 75 from a Teletype - This instruction is also 

used to re&d parameter strings ■&£ overlay 
calls. This instruction is illegal if 
LUN 100 is not a Teletype and there are no 
characters & the Teletype input string. 
See ACI. 

v ^"23-8 

ASCII character—^ ^__q 



CTO 

77.76 Console Teletype output — -write a character 

on a Teletype. This instruction is illegal 
if LUN 100 is not a Teletype® 

A<k -^ Teletype output buffer,. 
Teletype input string is discarded fe 
No registers are changed e 

ACI ASCII code to input string - put the ASCII 

77 - 54 , character in A ? _ on the end of the Teletype 

input string. This instruction is used to 

o 
put out parameter strings for Overlays or 

library calls * 

A- — > Teletype input string* 
No reaisters are changed * 



INTERRUPT CONTROL 



There are four instructions with which a user can test 
internal fault conditions and/or interrupt^ if a fault occurs 
There instructions have the following format: 
C 3 ■ 7 it 






en 



X 



f = 77 

g is a sub operation code 

ch = channel (should be zero) 

X = 12 bit mask used to select certain conditions 



An INTERRUPT stores into word m and jumps to 



+ 1 



cl 



532 2 



16 



15 



16. 







address of instruction 
to be executed next. 



1 RIS 
ROS 



m 



2 

4 

6 

10, 

12' 



Condition 

BCD FAULT 
DIVIDE FAULT 
ARITHMETIC OVERFLOW 
EXPONENTt3 FAULT 
MANUAL INTERRUPT 



INTERNAL STATUS 
BIT MASK CONDITION 



11 

10 

9 

8 



4000 
2000 
1000 
0400 



BCD FAULT T 
DIVIDE F/XA- 1 
ARITHMETIC OVERFLOW 
EXPONENT m& FAULT 



INTERRUPT MASK REGISTER 

9 1000 .EXPONENTS AND BCD FAULT 
x 10 2000 DIVIDELAND ARITHMETIC OVEKFLOW 



CINS . 

F.g 
77.30 



gopy internal status - internal status-»t? 
(A||ff^©? interrupt mask*-^^^ . 

(X = 0) 



INS Eternal sense - if any mteraai sta-cus 

77.3 line selected by X is & 1, &^ip next 

instruction* (ffl\ e > j ?s^J^h-~^ W^f/v 
(X T 0} 



SCIM Selectively clear|r interrupt mask - clear 

77, £~3 all ^j_ ts j_ n t v. e interrupt mask that £3 



SSIM ^Selectively set interrupt mask -.. set all 

77.52 bits in the interrupt mask that correspond 

to the 1 bits inl e 

RIS Relocate with instruction state register - 

55.0 . fetch operands from same memory bank ^S H| 

ROS Relocate with operand state register. Fetch 

55.4 operands from other memory bank ^) 

l ^^ SBJP Set boundary jump - normal termination of 

77,62 a user program. After executing this 

instruction a user will be put in control 

mode. If a user is on a TWif index 2 is 

zero the screen will be cleared. otherwise 

/ 
it will not be changed. 



SLS 



77.70 



Select stop - abnormal termination of a 
user program. After executing this 
instruction a user will be put in control 
mode and an error message will be printed. 
If the user types GO the instruction wfter 
the SLS will be executed. 



UCS 



77.77 



UNCONDITIONAL, StO? - see SLS 



COMPASS programmers should be aware that communication between 
some system routines and the monitor is carried on through RF77 
and therefore a user should not set or clear bits in R?77. 




